home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 31 / Amiga Format CD31 (1998-09-02)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1998-10].iso / -seriously_amiga- / sound / amigaamp / amigaamp.readme < prev    next >
Text File  |  1998-07-16  |  15KB  |  391 lines
  1. Short:    MPEG audio player with GUI (68k/PPC)
  2. Uploader: Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  3. Author:   Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  4. Type:     mus/play
  5. Version:  2.1
  6.  
  7. Homepage
  8. --------
  9. http://amigaamp.amiga-software.com
  10.  
  11.  
  12. Introduction
  13. ------------
  14. AmigaAMP is a GUI based MPEG audio player using mpega.library on the 68k
  15. processor or the amp decoding engine in the PPC version.  Sound is played
  16. back using the AHI audio system.  AmigaAMP is NOT another frontend for the
  17. CLI based mpega.  Anyway, if you've got problems not related to the user
  18. interface but with AHI, AsyncIO or mpega.library, PLEASE contact the
  19. corresponding author directly.  I wouldn't be able to help you in this
  20. case.
  21.  
  22.  
  23. Requirements (not included in this archive!)
  24. --------------------------------------------
  25. AmigaOS 3.0 or higher
  26. 68030-50MHz processor or better
  27. mpega.library    (Aminet:util/libs/mpega_library.lha)
  28. asyncio.library  (Aminet:dev/c/AsyncIO.lha)
  29. AHI audio system (Aminet:mus/misc/ahiusr.lha)
  30.  
  31.  
  32. Recommended
  33. -----------
  34. PowerUP and ppc.library v45
  35. AmigaOS 3.1 (OS3.1 AND PowerUP are needed for the spectrum analyzer!)
  36.  
  37. Features
  38. --------
  39.  - FREEWARE!  No beta, no nag requesters and no expiry date!
  40.  - GadTools based font sensitive user interface
  41.  - Alternatively WinAMP compatible user interface (new!)
  42.  - Workbench application (you can drop icons on its window)
  43.  - Easily configurable
  44.  - AHI device-level access (uses default audio mode automatically)
  45.  - PPC (PowerUP) support
  46.  - ID3 tag editor (artist, title, albm, etc.)
  47.  
  48. Limitations
  49. -----------
  50.  - The PPC version doesn't support MPEG2.5 yet, I'm working on it
  51.  - Only simple level meters in the 68k version
  52.  - No realtime spectrum when using AmigaOS 3.0 -- sorry guys!
  53.  - No realtime spectrum when playing MP2 files yet
  54.  
  55. History
  56. -------
  57. v2.1 - configurable playback buffer size (should cure many problems!)
  58.      - fixed a bug that caused truecolor skins to be dithered even on
  59.        truecolor screens
  60.      - Skin pictures can have any extension you like as long as the name
  61.        is correct.
  62.      - Fixed a bug in the PPC loader for 48 kHz MPEGs
  63.      - asynchronous filerequester
  64.      - Skins can be reloaded at any time.
  65.      - auto-play after opening a file if playback was active before opening
  66.      - corrected some skin positions
  67.      - visualisation for the 68k version, too (level meters)
  68.      - MaxFreq finally works
  69.  
  70. v2.0 - so many changes it was worth bumping the version number :-)
  71.      - position of genre listview gadget fixed
  72.      - fixed bugs when playing mono or 22.05 kHz files
  73.      - digital volume control
  74.      - AREXX interface (see AREXX.readme)
  75.      - automatic detection if another AmigaAMP task is already
  76.        running
  77.      - alphabetically sorted playlist (not editable yet)
  78.      - configurable buffersize
  79.      - WinAMP lookalike GUI (see below)
  80.      - Improved fontsensitivity of old GUI
  81.      - cached taginfo -- will be written when the file is closed
  82.  
  83. v1.1 - name changed to AmigaAMP
  84.      - PPC version
  85.      - ID3 tag editor
  86.      - commandline support
  87.  
  88. v1.0 - initial release called MPEGAHI
  89.  
  90. Getting started (configuration)
  91. -------------------------------
  92. Important! You need a properly installed and configured AHI audio system
  93. to run AmigaAMP. Without a correct setup the sound may be very poor!
  94.  
  95. First of all run the AHI setup program in your Prefs drawer. Select
  96. one of the units from 0 to 3 but not the Music unit. If you don't use
  97. unit 0 for anything already I recommend using that one.
  98.  
  99. Select one of the "fast stereo++" audiomodes that matches your audio
  100. hardware. For Prelude playback I recommend "Prelude:Fast 16 bit stereo++
  101. realtime".
  102.  
  103. Now you need to know what sampling rate most of your MPEG files
  104. have. Probably it's 44100 Hz because that's the standard CD rate. If
  105. you have a slow processor you may want to run AmigaAMP in frequency division
  106. mode to reduce CPU load. Have a look at the table below for the recommended
  107. settings.
  108.  
  109. It is important to set the frequency slider to your mostly used frequency
  110. divided by your chosen frequency divisor. For example, if you're going to
  111. playback lots of 44100 Hz MPEGs and frequency division is 1:2, set the
  112. Frequency slider to 22050 Hz.
  113.  
  114. If you don't plan to have several programs playing back audio at the
  115. same time, please leave the Channels slider at position 1. The remaining
  116. settings depend on your audio hardware.
  117.  
  118. Ok, press the "Save" button in the bottom left corner.
  119.  
  120. Now it's time to configure AmigaAMP itself. If you've chosen another
  121. AHI device than 0, you have to change the AHIUNIT tooltype of AmigaAMP
  122. first. If not, just start it by double clicking on its icon and pop up
  123. the setup window by chosing Config... from the menu.
  124.  
  125. Set the sliders and checkmarks to the recommended settings, save them using
  126. the menu and close the settings window again.
  127.  
  128. That's it! AmigaAMP is now configured. You may want to fine-tune the
  129. settings later. The overall performance depends on the speed of mpega.library
  130. AND the the speed of your soundcard's AHI driver.
  131.  
  132. Recommended settings (tested with Prelude:Fast 16 bit stereo++ realtime)
  133. ------------------------------------------------------------------------
  134.  
  135.           |     Layer 1/2        |        Layer 3
  136. Processor | Quality|FreqDiv|Mono | Quality|FreqDiv|Mono
  137. ----------+--------+-------+-----+--------+-------+-----
  138. 68040-40  |  high  |  1:2  | off | medium |  1:2  | on 
  139. 68060-50  |  high  |  1:1  | off |  high  |  1:1  | off
  140. PPC604e   |  high  |  1:1  | off |  high  |  1:1  | off
  141.  
  142. Note: In fact only the 68k version is affected by these settings.
  143.  
  144.  
  145. Advanced settings
  146. -----------------
  147. * Bufsize:
  148. Set the size of the read ahead buffer. Try playing with it until you
  149. get best results. (Normally 16 to 32K is best)
  150.  
  151. * TaskPri:
  152. Set the running task priority of AmigaAMP. The recommended value for
  153. uninterrupted playback is 1. God knows what happens if some 3rd party
  154. task rescheduler starts fiddling around with AmigaAMP's internal task
  155. priorities...
  156.  
  157. * Read ID3 TagInfo
  158. Try to read information about artist, title, etc. Because those are stored
  159. at the end of the file it may slow down loading a bit. If this function
  160. is switched off, TagInfo can neither be edited nor saved!
  161.  
  162. * Allow multiple instances
  163. Normally when you click on an MPEG file project icon while AmigaAMP is
  164. already playing another one, no second AmigaAMP task will be launched but
  165. the already running task will start playing the new file. This behaviour
  166. can be switched off. You have to start AmigaAMP twice manually and then
  167. save the config with "Allow multiple instances" switched on from both
  168. running tasks.
  169.  
  170. * Limit volume to 0dB
  171. The volume slider ranges from silence to +6dB volume so that you can boost
  172. more silent recordings. If you don't want to turn the volume above normal
  173. accidentally, you can switch on this option.
  174.  
  175. * ToolType: DIRECTORY
  176. Default directory to display in filerequester.
  177.  
  178. Usage (how to load and play sounds)
  179. -----------------------------------
  180. Most of the buttons should be self-explanatory because they can be found
  181. on almost every CD player or tapedeck. However, as a computer program,
  182. AmigaAMP is based on files, so there may be slight differences. The bottom
  183. line buttons from left to right are:
  184.  
  185.  - Eject      Stops playback, empties the current playlist and opens a
  186.               requester to select one or more files
  187.  - Skip back  Moves to the previous track in the playlist if there is one.
  188.  - Stop       Simply stops playback. (What else did you expect? :-)
  189.  - Play       Starts playback if there's at least one track in the current
  190.               playlist. If it's not, opens a requester to select tracks.
  191.  - Skip fwd   Moves to the next track in the playlist if there is one.
  192.  - Pause      Pauses playback at the current position
  193.  
  194. Just above the control button's there's a position slider. As you play
  195. a file, it's button moves from left to right to display the relative
  196. playback position within the current track. You can use the mouse to drag
  197. this slider to a new position.
  198.  
  199. About the WinAMP GUI
  200. --------------------
  201. Since WinAMP v1.80 you can load customizeable textures (so called skins) for
  202. the GUI. The skins consist of several bitmapped pictures together in one
  203. directory and contain the the look of the window itself as well as images
  204. for all the gadgets. Because more and more people ask me to make AmigaAMP
  205. look like WinAMP I now included an alternative GUI routine that can load
  206. those WinAMP skins!
  207.  
  208. I've included my three favourite examples in the "skins" directory. There
  209. are three subdirectories called
  210.  
  211.  - base      -> the original WinAMP design
  212.  - sex       -> a very colourful appearance :-)
  213.  - eXquisite -> wood case and polished brass knobs :)
  214.  
  215. To activate one of those GUIs you have to start AmigaAMP with the options
  216. NewGUI and Skin=<subdirectory name>. If you just want the WinAMP like basic
  217. look you can simply type "AmigaAMP NG" where NG is the shortcut for NewGUI.
  218. For the other designs a highcolor display mode on a graphics card
  219. is strongly recommended.
  220.  
  221. Although the pictures all have the extension .iff they can be any format
  222. that you have a datatype for. If you find a working BMP datatype (try
  223. loading the pictures with multiview first) you can even copy WinAMP skins
  224. direcly. AmigaAMP will try to load pictures with the extensions iff or bmp
  225. automatically.
  226.  
  227. At the moment not everything of the WinAMP GUI is really functional. For
  228. example there's no spectrum analyzer for MP2, no graphic EQ and the shuffle
  229. button won't work either. Anyway, most of the rest is working!
  230.  
  231.  
  232. Legal stuff
  233. -----------
  234. AmigaAMP is copyrighted freeware. It may be distributed freely as long as
  235. no modifications are made to the executable and this document. A nominal
  236. fee may be asked to cover distribution costs.
  237.  
  238. AmigaAMP may not be used for any commercial purposes or included with any
  239. commercial product without the written permission of the author. It may
  240. NOT be stored on ftp servers or websites that also hold commercial software
  241. products or drivers for commercial hardware. The only exception are servers
  242. of the Aminet archive.
  243.  
  244. No responsibilities are taken for damaged speakers, amplifiers, Amigas
  245. or any other components or data involved while using AmigaAMP.
  246.  
  247. Although I've done some beta testing I can't guarantee that AmigaAMP will
  248. not crash! If you find any bugs, let me know.
  249.  
  250. Here's the original amp.readme:
  251. -------------------------------
  252. amp MPEG audio decoder readme file (version 0.7.5)
  253. (C) Tomislav Uzelac  1996,1997
  254.  
  255. amp is free software and can be _used_ freely by anyone. If you want to
  256. do anything else with it, be sure to check the Legal section of this
  257. document for legal issues.
  258.  
  259. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  260. of this document.
  261.  
  262. 1. Introduction
  263. 2. Installation
  264. 3. Running
  265. 4. Feedback
  266. 5. Contributing
  267. 6. Legal
  268.  
  269.  
  270. 1. Introduction
  271.  
  272. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  273. putting together as a side project of the MPEG hardware design project at 
  274. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  275. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  276. defined in MPEG2), layers 2 and 3. 
  277.  
  278. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  279. available at the amp home site ftp://ftp.rasip.fer.hr
  280.  
  281. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  282.  
  283. The following people contributed their time and knowledge to amp:
  284. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  285. Edouard Lafargue, Andrew Richards, George Colouris,
  286. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  287.  
  288. amp home location is
  289.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  290.  
  291. and the mailing list: send 'HELP' in the body of the message to:
  292.     multimedia@rasip.fer.hr
  293.  
  294. If you want to find out more about MPEG, best places to start are
  295.     http://www.mpeg.org
  296.     http://www.mpeg2.de 
  297.  
  298.  
  299. 2. Installation
  300.  
  301. Installation should be simple enough if amp was ported to your system,
  302. just do a 
  303.  
  304. ./configure
  305. make 
  306.  
  307. You can edit the makefile further to suit your system. If configure fails 
  308. to make a usable Makefile, you'll _have_ to edit it yourself.
  309.  
  310. Linux users should try real-time playing support, as described
  311. in doc/realtime.txt. Some people that might pass on this feature are
  312. those with slower machines (i.e. 486's), or SMP systems (see the
  313. doc/linuxrealtime.txt file). 
  314. Some versions of the linux C library produce an error when compiling
  315. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  316. and replace _P in the offending line with __P.
  317.  
  318. ./configure --enable-realtime
  319. make
  320. chown root.root amp
  321. chmod u+s amp
  322.  
  323. ... this requires /dev/dsp to be both world readable and writeable. If you
  324. have a special group for people allowed to use the sound device (for
  325. instance, a group called sound), you can do a:
  326.  
  327. chmod g+s amp
  328.  
  329. or make your audio card world read/writeable (not recomended)
  330.  
  331. chmod o+rw /dev/dsp*
  332.  
  333. 3. Running:
  334.  
  335. 'amp -h' gives you usage & options. If your computer is on the slower
  336. side, direct playback might not work, but you can decode it
  337. to .wav or raw pcm and play it later.
  338.  
  339.  
  340. 4. Feedback
  341.  
  342. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  343. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  344.  
  345. If you find any mpeg audio files that amp has trouble decoding, please tell
  346. me about this via e-mail <tuzelac@rasip.fer.hr>.
  347.  
  348.  
  349. 5. Contributing
  350.  
  351. Please contribute to amp. If you want to know what is going on in amp 
  352. development, you can join the developers mailing list
  353.  
  354.     mpeg_audio_developers@rasip.fer.hr
  355.  
  356. There are certain debugging facilities that I made in amp, but are disabled
  357. in the current release (they are neither nice nor user-friendly). If anyone
  358. enhances them (they are in dump.c) to the point that they're actually
  359. usable I'll be happy to include the changes in the release. I think this
  360. kind of debug output would be very useful to people studying these audio
  361. algorithms.
  362.  
  363.  
  364. 6. Legal
  365.  
  366. This software can be used freely for any purpose. It can be distributed
  367. freely, as long as it is not sold commercially without permission from
  368. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  369. on CD_ROMs containing other free software is explicitly permitted even 
  370. when a modest distribution fee is charged for the CD, as long as this
  371. software is not a primary selling argument for the CD.
  372.  
  373. Building derived versions of this software is permitted, as long as they
  374. are not sold commercially without permission from Tomislav Uzelac 
  375. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  376. such, and must be called by a name other than amp. Any derived versions
  377. must retain this copyright notice.
  378.  
  379. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  380.  * not mention being copyrighted itself :)
  381.  */
  382.  
  383. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  384. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  385. any damages that might occur to your computer, software, etc. in
  386. consequence of you using this freeware program.
  387.  
  388.  
  389. Tomislav Uzelac
  390. <tuzelac@rasip.fer.hr>
  391.